home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Multimedia / Resource Library: Multimedia.iso / utils / graphic / viewers / general / msdos / ncsa / readme.doc
Encoding:
Text File  |  1989-06-20  |  4.5 KB  |  111 lines
  1. This is version 1.1 of NCSA PCShow
  2.  
  3. Changes in Version 1.1:   due to popular demand, the capability
  4. to animate multiple .HDF files was added.  Also it is now
  5. possible to do wildcarding on the image names of animations in
  6. both the "single file" and the "list of files" modes.
  7.  
  8. Changes in Version 1.01:  a small bug was corrected in the
  9. uncompression scheme for run length compressed images from the
  10. 1.0 version.  Additionally, a define statement was included in
  11. all the .c files to allow compilation without mouse support
  12. routines.  Also the batch file must be changed in the link
  13. statement to delete the msmouse library if mouse functions aren't
  14. used.
  15.  
  16. PC Show is a public domain program designed for displaying raster
  17. 8 bit binary images and images contained in HDF files.  It will
  18. display these images on VGA, EGA, and Number 9 Revolution 512
  19. monitors; future releases will support display by Targa boards. 
  20.  
  21. The following files are necessary for correct program compilation
  22. with Lattice C 3.1:
  23.     
  24.     pcshow.c    - contains the main i/o routines
  25.     options.c    - contains the main image manipulation routines
  26.     parse.c    - contains the command parsing routine
  27.     vga.asm    - assembly language routines for vga monitor
  28.     ega.asm    - assembly routines for ega monitor
  29.     no9.asm    - assembly routines for NO9 monitor
  30.     dosio.asm    - assembly routines to access dos commands
  31.     df.h        - HDF header file
  32.     dfi.h    - more HDF header information
  33.     tardev.h    - header file for future targa developement
  34.     fcntl.h    - Lattice C routines
  35.     stdio.h    - standard i/o routines
  36.     stdlib.h    - more i/o routines
  37.     time.h    - some time routines for random number seeding
  38.     math.h    - some math routines needed for interpolating
  39.     df.lib    - HDF library functions
  40.     makeshow.bat    - a batch file to compile and link all the
  41.                     files
  42.     pcshow.exe    - executable code for systems without a mouse
  43.     pcshowm.exe    - executable code for systems with a mouse
  44.     pcshow.doc.ascii    - documentation for PC Show in ascii
  45.                         format
  46.  
  47. The following files will have to be provided by the user for
  48. correct compilation and linking:
  49.     msmouse.lib    - mouse support routines - found on the
  50.                         mouse support disk provided with
  51.                         your mouse
  52.     dos.mac     - file provided with lattice C
  53.  
  54. Future releases will contain more mouse and Targa graphics
  55. support, more image manipulation functions, and possibly some
  56. palette manipulation tools are contemplated.
  57.  
  58. Documentation can be found in pschow/docs in both ascii format
  59. and a Microsoft Word document which has been run through stuffit
  60. and then binhex.
  61.  
  62. The source code as individual files are found in pcshow/src, a
  63. copy of the executable file can be found in pcshow/bin, and a
  64. tar'ed file of all the source code can be found in pcshow/tar.
  65.  
  66. There are two copies of the executable code in the PCShow/bin
  67. directory.  PCSHOW.EXE will work with or without a mouse, since
  68. it doesn't use any of the mouse routines and will perform exactly
  69. as the documentation specifies.
  70. PCSHOWM.EXE calls mouse dependant functions; it will NOT work
  71. correctly without a mouse attached to the computer.  (The mice
  72. used for testing it were a PCSYSTEMS optical mouse and a standard
  73. IBM mouse.)  The mouse routines are not documented or rigorously
  74. tested, but appear to be fully functional for scrolling the image
  75. (click on an edge of corner) and for moving the color bar (click
  76. and hold down button on the color bar and move the mouse to
  77. re-locate the color bar).
  78.  
  79. Some small HDF images are found in the pcshow/images/hdf
  80. directory.  These are useful to test out the performance of
  81. PCShow after it has been compiled.  A larger raster image and
  82. palette are found in the pcshow/images/raster directory.  This is
  83. useful for verifying binary images and as an example format for
  84. raw raster palettes.  Some useful sample palettes have been
  85. included in the pcshow/palettes directory.
  86.  
  87. This software was produced at NCSA at University of Illinois at
  88. Urbana/Champaign.  Please notify us of any bugs you have found in
  89. our software and any suggestions you have for future releases or
  90. products.
  91.  
  92. Mail user feedback, software suggestions, or bugs to:
  93.  
  94. NCSA Software Development
  95. 152 Computing Applications Bldg.
  96. 605 E. Springfield Ave. 
  97. Champaign, IL 61820
  98.  
  99. Send reports regarding bugs via electronic 
  100. mail to:
  101.  
  102. bugs@ncsa.uiuc.edu
  103. bugs@ncsavmsa.bitnet
  104.  
  105. Send reports regarding software suggestions 
  106. or comments via electronic mail to:
  107.  
  108. softdev@ncsa.uiuc.edu
  109.  
  110. Thank You for using NCSA PCShow!
  111.